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Abstract 


BGP communities (RFC 1997) are used by service providers for many 
purposes, including tagging of customer, peer, and geographically 
originated routes. Such tagging is typically used to control the 
scope of redistribution of routes within a provider’s network and to 
its peers and customers. With the advent of large-scale BGP data 
collection (and associated research), it has become clear that the 
information carried in such communities is essential for a deeper 
understanding of the global routing system. This memo defines 
standard (outbound) communities and their encodings for export to BGP 
route collectors. 
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1. Introduction 


BGP communities [RFC1997] are used by service providers for many 
purposes, including tagging of customer, peer, and geographically 


originated routes. Such tagging is typically used to control the 
scope of redistribution of routes within a provider's network and to 
its customers and peers. Communities are also used for a wide 


variety of other applications, such as allowing customers to set 
attributes such as LOCAL PREF [RFC1771] by sending appropriate 
communities to their service provider. Other applications include 
signaling various types of Virtual Private Networks (VPNs) (e.g., 
Virtual Private LAN Service (VPLS) [VPLS]), and carrying link 
bandwidth for traffic engineering applications [RFC4360]. 


With the advent of large-scale BGP data collection [RV] [RIS] (and 
associated research), it has become clear that the geographical and 
topological information, as well as the relationship the provider has 


to 
in 


the source of a route (e.g., transit, peer, or customer), carried 
such communities is essential for a deeper understanding of the 


global routing system. This memo defines standard communities for 
export to BGP route collectors. These communities represent a 
Significant part of information carried by service providers as of 
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this writing, and as such could be useful for internal use by service 
providers. However, such use is beyond the scope of this memo. 
Finally, those involved in BGP data analysis are encouraged to verify 
with their data sources as to which peers implement this scheme (as 
there is a large amount of existing data as well as many legacy 
peerings). 


The remainder of this memo is organized as follows. Section 2 
provides the definition of terms used as well as the semantics of the 
communities used for BGP data collection, and Section 3 defines the 
corresponding encodings for RFC 1997 [RFC1997] communities. Finally, 
Section 4 defines the encodings for use with extended communities 
[RFC4360]. 


2. Definitions 


In this section, we define the terms used and the categories of 
routes that may be tagged with communities. This tagging is often 
referred to as coloring, and we refer to a route’s "color" as its 
community value. The categories defined here are loosely modeled on 
those described in [WANG] and [HUSTON]. 


2.1. Peers and Peering 


Consider two network service providers, A and B. Service providers A 
and B are defined to be peers when (i) A and B exchange routes via 
BGP, and (ii) traffic exchange between A and B is settlement-—free. 
This arrangement is also typically known as "peering". Peers 
typically exchange only their respective customer routes (see 
"Customer Routes" below), and hence exchange only their respective 
customer traffic. See [HUSTON] for a more in-depth discussion of the 
business models surrounding peers and peering. 


2.2. Customer Routes 


Customer routes are those routes that are heard from a customer via 
BGP and are propagated to peers and other customers. Note that a 
customer can be an enterprise or another network service provider. 
These routes are sometimes called client routes [HUSTON]. 


2.3. Peer Routes 


Peer routes are those routes heard from peers via BGP, and not 
propagated to other peers. In particular, these routes are only 
propagated to the service provider’s customers. 
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2.4. Internal Routes 


Internal routes are those routes that a service provider originates 
and passes to its peers and customers. These routes are frequently 
taken out of the address space allocated to a provider. 


2.5. Internal More Specific Routes 


Internal more specific routes are those routes that are frequently 
used for circuit load balancing purposes and Interior Gateway 
Protocol (IGP) route reduction. They also may correspond to customer 
services that are not visible outside the service provider’s network. 
Internal more specific routes are not exported to any external peer. 


2.6. Special Purpose Routes 


Special purpose routes are those routes that do not fall into any of 
the other classes described here. In those cases in which such 
routes need to be distinguished, a service provider may color such 
routes with a unique value. Examples of special purpose routes 
include anycast routes and routes for overlay networks. 


2.7. Upstream Routes 


Upstream routes are typically learned from an upstream service 
provider as part of a transit service contract executed with the 
upstream provider. 


2.8. National Routes 


These are route sets that are sourced from and/or received within a 
particular country. 


2.9. Regional Routes 


Several global backbones implement regional policy based on their 
deployed footprint and on strategic and business imperatives. 

Service providers often have settlement-free interconnections with an 
Autonomous System (AS) in one region, and that same AS is a customer 
in another region. This mandates use of regional routing, including 
community attributes set by the network in question to allow easy 
discrimination among regional routes. For example, service providers 
may treat a route set received from another service provider in 
Europe differently than the same route set received in North America, 
as it is common practice to sell transit in one region while peering 
in the other. 
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3; 


RFC 1997 Community Encoding and Values 


In this section, we provide RFC 1997 [RFC1997] community values for 
the categories described above. RFC 1997 communities are encoded as 
BGP Type Code 8, and are treated as 32-bit values ranging from 
0x0000000 through OxFFFFFFF. The values 0x0000000 through 0x0000FFFF 
and OxFFFFO000 through OxFFFFFFFF are reserved. 


The best current practice among service providers is to use the 
high-order two octets to represent the provider’s AS number, and the 
low-order two octets to represent the classification of the route, as 
depicted below: 


0 1 2 3 
01234567890123456789012345678<901 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +H 
| <AS> | <Value> | 
+-+-+-+-+-+-+-+-+-+-+-+-+ +H 


where <AS> is the 16-bit AS number. For example, the encoding 
0x2A7C029A would represent the AS 10876 with value 666. 


Community Values for BGP Data Collection 


In this section, we define the RFC 1997 community encoding for the 
route types described above for use in BGP data collection. It is 
anticipated that a service provider's internal community values will 
be converted to these standard values for output to a route 
collector. 


This memo follows the best current practice of using the basic format 
<AS>:<Value>. The values for the route categories are described in 
the following table: 
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Category Value 
Reserved <AS>:0000000000000000 
Customer Routes <AS>:0000000000000001 
Peer Routes <AS>:0000000000000010 
Internal Routes <AS>:0000000000000011 
Internal More Specific Routes <AS>:0000000000000100 
Special Purpose Routes <AS>:0000000000000101 
Upstream Routes <AS>:0000000000000110 
Reserved <AS>:0000000000000111- 
<AS>:0000011111111111 
National and Regional Routes <AS>:0000100000000000- 
<AS>:1111111111111111 
Encoded as <AS>:<R><X><CC> 
Reserved National and Regional values <AS>:0100000000000000- 


<AS>:1111111111111111 
Where 


<AS> is the 16-bit AS 
<R> is the 5-bit Region Identifier 
<X> is the 1-bit satellite link indication 
x = 1 for satellite links, 0 otherwise 
<CC> is the 10-bit ISO-3166-2 country code [1S03166] 


and <R> takes the values: 


Africa (AF) 00001 
Oceania (OC) 00010 
Asia (AS) 00011 
Antarctica (AQ) 00100 
Europe (EU) 00101 
Latin America/Caribbean Islands (LAC) 00110 
North America (NA) 00111 
Reserved 01000-11111 
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That is: 


0 1 2 3 
0-4-2343 6 7°89: 0-4. 2B 4D 678 9 Od 23 A 67 BO. 0 A 
+—F-t-t-t-4-4-4-4-4-4-4F FFF atti to titit oti tatatatat-t-t-t—t 
| <AS> | <R> Jx] <CC> | 
+-F-t-t-t-4-4-4-4-4-4-4F-F Ft tattoo toto tit titi tatatatotototot 


For example, the encoding for a national route over a terrestrial 
link in AS 10876 from the Fiji Islands would be: 


<AS> = 10876 = Ox2A7C 

<R> = 00010 

<X> = 0 

<CC> = Fiji Islands Country Code = 242 = 0011110010 


In this case, the low-order 16 bits are 0001000011110010 = Ox10F2. 


0 1 2 3 

01234567890123456789012345678901 
tot-t—t-t-t-4t-4t-4F-F-4F-4-4-4-4-t-t-4-4-4- 4-44-44 -t-totatatat-tat 
| Ox2A7C | Ox1l0F2 | 
to—t—t-4t-4t-4t-4t-4t-4+-4F-4-4-4-4-4-4-4-4-4-4-4- 4-44-44 -totatatatatat 


Note that a configuration language might allow the specification of 
this community as 10876:4338 (0x10F2 == 4338 decimal). 


Finally, note that these categories are not intended to be mutually 
exclusive, and multiple communities can be attached where 
appropriate. 


4.1. Extended Communities 


In some cases, the values and their encoding described in Section 4 
may clash with a service provider’s existing community assignments. 
Extended communities [RFC4360] provide a convenient mechanism that 
can be used to avoid such clashes. 


The Extended Communities attribute is a transitive optional BGP 


attribute with the Type Code 16 and consists of a set of extended 
communities of the following format: 
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0 1 2 3 
CLO S456 7S90 LSS 4aS ST 8 oO 103-4 Ge 7 8 OO 4 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ 

| Type high | Type low(*) | 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Value 


+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-++ 


For purposes of BGP data collection, we encode the communities 
described in Section 4 using the two-octet AS specific extended 
community type, which has the following format: 


0 1 2 3 
Od 2 34S OF 89 (Od BS. 4, B96. 8s OO: Te 23 4 6s 7-8 9 Oo. 
+-+-+-+-+-+-+-+-+-+-+-+-+ +H 

| 0x00 | Sub-Type | Global Administrator 

+-+-+-+-+-+-+-+-+-+-+- +++ 
| Local Administrator | 
+-+-+-+-+-+-+-+-+-+-+-+ +H 


The two-octet AS specific extended community attribute encodes the 
service provider's two-octet Autonomous System number (as assigned by 
a Regional Internet Registry, or RIR) in the Global Administrator 
field, and the Local Administrator field may encode any information. 


This memo assigns Sub-Type 0x0008 for BGP data collection, and 
specifies that the <Value> field, as defined in Section 3.1, is 
carried in the low-order octets of the Local Administrator field. 
The two high-order octets of the Local Administrator field are 
reserved, and are set to 0x00 when sending and ignored upon receipt. 


For example, the extended community encoding for 10876:4338 
(representing a terrestrial national route in AS 10876 from the Fiji 
Islands) would be: 


0 il 2 3 
ON be 23. 4:9: 66 PF BO Qed. 2-3-4 Ob E o a 9 Ok 23 4A 6 PB ~ 907 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ 


| 0x00 | ox0008 ć | 0x2A7C | 
+-+-+-+-+-+-+-+-+-++tH HHHH HHHH 
| 0x00 | 0x00 | 0x10F2 | 


+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ 
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4.2. Four-Octet AS Specific Extended Communities 
The four-octet AS specific extended community is encoded as follows: 
0 j 2 3 


01l 234567890123 456 789 0 1234 567890 I 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-++ 


| 0x02 | 0x0008 | Global Administrator 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+++++ 
| Global Administrator (cont.) | 0x10F2 


+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ 


In this case, the four-octet Global Administrator sub-field contains 
a four-octet Autonomous System number assigned by the IANA. 


5. Note on BGP UPDATE Packing 


Note that data collection communities have the potential of making 
the attribute set of a specific route more unique than it would be 
otherwise (since each route collects data that is specific to its 
path inside one or more ASes). This, in turn, can affect whether 
multiple routes can be grouped in the same BGP update message, and it 
may lead to increased use of bandwidth, router CPU cycles, and 
memory. 
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7. Security Considerations 


While this memo introduces no additional security considerations into 
the BGP protocol, the information contained in the communities 
defined in this memo may in some cases reveal network structure that 
was not previously visible outside the provider’s network. As a 
result, care should be taken when exporting such communities to route 
collectors. Finally, routes exported to a route collector should 
also be tagged with the NO_EXPORT community (OxFFFFFFO1). 


7.1. Total Path Attribute Length 


The communities described in this memo are intended for use on egress 
to a route collector. Hence an operator may choose to overwrite its 
internal communities with the values specified in this memo when 
exporting routes to a route collector. However, operators should in 
general ensure that the behavior of their BGP implementation is 
well-defined when the addition of an attribute causes a PDU to exceed 
4096 octets. For example, since it is common practice to use 
community attributes to implement policy (among other functionality 
such as allowing customers to set attributes such as LOCAL_PREF), the 
behavior of an implementation when the attribute space overflows is 
crucial. Among other behaviors, an implementation might usurp the 
intended attribute data or otherwise cause indeterminate failures. 
These behaviors can result in unanticipated community attribute sets, 
and hence result in unintended policy implications. 


8. IANA Considerations 


This memo assigns a new Sub-Type for the AS specific extended 
community type in the First Come First Served extended transitive 
category. The IANA has assigned Sub-Type 0x0008 as defined in 
Section 4.1. 


In addition, the IANA has created two registries for BGP Data 
Collection Communities, one for standard communities and one for 
extended communities. Both of these registries will initially be 
populated by the values described in Section 4. IETF Consensus, as 
described in [RFC2434], usually through the Global Routing Operations 
Working Group (grow), is required for the assignment of new values in 
these registries (in particular, for <Value> or <R> in the table of 
values for the route categories in Section 4). 
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